Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / ace.arc / ACE.DOC next >

Wrap

Text File | 1985-06-09 | 22.6 KB | 463 lines

╔════════════════════════════════════════════════════════╗ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ACE▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒(Ver 1.21)▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒┌------------┐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒├ BY ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒└------------┘▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒Patrick Bennett▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒▒▒▒All rights reserved, Copyright 1985 C-STUFF co.▒▒▒▒▒║ ║▒▒▒R.R.#12 Box #19 Muncie, IN 47302 (317)288-7547▒▒▒▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒ If you are using this program, find it of value, ▒║ ║▒ and would like for me to write more, ▒║ ║▒your contribution ($35 suggested) will be appreciated.▒║ ║▒read documentation for info. on contribution benefits.▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║▒You are encouraged to copy and share this program with▒║ ║▒other users, on the conditions that the program is not▒║ ║▒ distributed in modified form, that no fee or ▒║ ║▒ consideration is charged and that this notice is not ▒║ ║▒ bypassed or removed. ▒║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚════════════════════════════════════════════════════════╝ Loading ACE... You can load ACE four different ways: 1. Type "ace" on the A> prompt. This will load the editor and then ask for the file you wish to edit. 2. Type "ace" followed by a space and the name of the file you wish to load, e.g. A>ace example.c. This example would load the editor, then load the file "example.c" into its buffer. 3. Type "ace/l" which will load the last file you edited automatically without displaying the logo. 4. When you become a registered user, information will be sent to you allowing a fourth method of loading the editor. Using ACE... MOVING THE CURSOR To move the cursor up, down, left, and right use the arrow keys. To move the cursor one word to the left hit the Ctrl key then the left arrow key. To move the cursor one word at a time to the right press the Ctrl key then the right arrow key. To go to the beginning of a line press the Home key. To go to the end of a line press the End key. To go to the top of the window press the Ctrl key then the Home key. To get to the bottom of the window press the Ctrl key then the End key. To scroll a page up towards the beginning of the file press the PgUp key. To scroll a page down towards the end of the file press the PgDn key. To go to the beginning of the file press the Ctrl key then PgUp key. To go to the end of the file press the Ctrl key then the PgDn key. When you look at the left side of the screen, you will see a marker. This marker shows you where you are in your document relative to the beginning and end of the current file If the marker is in the middle of the screen, you are around the middle of the document. ACE - Page 2 - Press the Scroll Lock key and "SCRL" will appear at the top of the screen, indicating that you are in a special mode. When in this mode, some of the keys' meanings change. The Home key now will move the cursor to the left side of the screen (as opposed to the start of a line). The End key will go move it to the right side of the screen. The up arrow will scroll up a half screen. The down arrow will scroll down half a screen. The left arrow will scroll left 4 times the tab size. The right arrow will scroll right 4 times the tab size. Also, you may move the cursor beyond the end of a line. When you are beyond the end of a line, as soon as you press a character key ACE will automatically pad spaces from the end of the line to the cursor. It then inserts the character. This padding also works for block moves, copies, etc. When you are beyond the end of the line the destructive backspace acts just like the left arrow, and the delete key is disabled. INSERTING TEXT Whenever the cursor is a large block, you are in insert mode. If it is small, you are in overtype mode. When you are in insert mode, each time you press a key all the text from the cursor on is moved over a character and the key you pressed is inserted in the new space. When you are in overtype mode, the character you press replaces whatever is under the cursor. If you want to toggle the insert and overtype modes, you just press the Ins key. DELETING TEXT If you want to delete text you can use the backspace key, the delete key, block delete, or a line delete. The backspace key when in insert mode, takes all the text from the cursor on and moves it one character to the left, replacing the character to the left of the cursor. The Del key takes the text next to the cursor and moves it over so that it replaces the character beneath the cursor. Before you can do a block delete you must DEFINE A BLOCK. To do this place the cursor at the beginning or ending of the text you want to define as a block. Press the F6 key. This starts the definition of a block, now move the cursor you will see the text highlighted as you move along. When you finish marking off the text you want defined as a block press the F6 key again. This stops the definition. Now if you want to delete the block press Alt and D for delete and the block will be deleted. Other uses for the blocks are explained below. To automatically delete a line without having to define it as a block just press Alt and the E key for erase. This will delete the line that the cursor is on. USING BLOCKS Block operations are powerful; they allow you to easily make large changes which would otherwise be tedious and time consuming. An example is Copy Block. To do this, define a block (see above), then just press the Alt key then the C key (for "copy") and a copy of the block will be inserted at the cursor position. You can also move a block, which means delete it then place it at the cursor position. To do this press the Alt key then the M key. ACE makes changing whole chunks of code easier by combining deleting and changing into one operation. You can press the Alt key and the L key to delete the line the cursor is on and replace it with the block. Press the Alt key and the B key to delete everything within the nearest braces { } and insert a copy of the block. NOTE: You may not you use the Alt C, M, L, or B commands while the cursor is in the block. But you may use the Alt D command while the cursor is in the block. ACE - Page 3 - MISCELLANEOUS EDITING FEATURES Sometimes you may need to place SPECIAL CHARACTERS in the text that ACE normally will not let you use (ASCII codes 215-255). To do this press the Alt Key then the X key. ACE will then place the cursor at the top of the screen. Type in the code you would like to insert or overtype (depending on the mode you're in) and press the return key. That character will then be placed in the text. (Note: you may not insert code 254!). NOTE: When editing a file all character 174's are displayed as 254's. When you save the file all the 254's are converted back to 174's. Also, if you press the ALT O key no matter where you are in a line it will INSERT A LINE below the current line and space that line over so that it is below the first non space in the old line. ACE contains special functions to help you in writing programs, C programs in particular. One of these is the Alt R command; this places at the cursor a */ then scans the line and figures out what kind of line it is (code or comment). It then places at the appropriate place a /*. It will also if you have defined a block and the cursor is within the block, place remarks around the block. This is helpful when you want the compiler to ignore a whole section of code. USER DEFINABLE WINDOWS When programming, there always seem to be things which you need periodically but not often enough to commit to memory. Wouldn't it be handy if, instead of getting out K&R or some other book or document, and looking up something in the index, finding the correct page, etcetera, you could create help windows, callable from inside your editor? Ace gives you this capability by allowing you to open a window in the top half of the screen into which you can load any maximum 2K file. You may only scroll through this file; you may not edit it. To open this window press the Alt key then F2 this will give you a choice between opening or closing the window. Select Open, then type in the name of the file to load. If you want to close it just select Close. When you are in the top window the arrow keys scroll. When you want to switch between windows, press Alt F1. You can tell which window you're in by where the ACE sign is. Some sample help files (with the extension ".hlp") have been included. Of course, help files are only one possible use for the window; any type of file may be loaded into it. USING THE MENUS To access the main menu press the Esc key. You will be shown a list of options. To select one, just press the capitalized letter you see in that option. The main menu options are: Files - This takes you to the Files submenu which is: * Load - Allows you to load a file. * Save - Allows you to save the current file with the same name or with a different name. To save it with the same name just press enter when it asks you for the filename, otherwise type in the name of the file and press return. * Rename - Allows you to change the name of a file on disk. If you want the name of the file you are working on to be changed just press enter for the old filename prompt then type in the new name for the new name prompt and it will be changed. * Erase - This allows you to delete the file you specify from the disk. ACE - Page 4 - * Block - This takes you to the Block submenu which looks like this: - Load - Allows you to load a file which is then marked as a block and placed at the end of the current file. - Save - Allows you to take a block you have defined and save it to a file. * Print - Allows you to print the file or block out on a printer with or without line numbers. It will print out the block if the cursor is within the block otherwise it will print the entire file. * sTatus - Shows you the file you are working on and the length of it in bytes. * Quit - allows you to quit the editor. * Dos - allows you to exit to dos and run another program or execute dos commands while keeping ACE in memory. Type EXIT at the dos prompt to return to ACE. (You must be using dos 2.0 or higher to use this function.) Search - Takes you to a sub-menu where you instruct ACE to search for a string. Replace - Sub-menu to search for a string and replace it with another string. Goto - Allows you to go to a line number or to a tagged position. Tag - Allows you to tag a line so that you can later go to it without having to remember line numbers. Version - Shows the name of the user and serial number. Attributes - Allows you to change the attributes of the editor, color, block color, border color, etc. USING SEARCH When you select the search command your screen should look like this: Search string: DIRECTION: Up Down CASE: Yes No Some of the options should also be inside parentheses, meaning they are selected. The direction field is just the direction the search goes from the cursor. The case field specifies whether a string found in the text has to match the search string exactly or if they can be somewhat different, for example. If you searched for Int with case set to yes, it would only find Int not int. If the case was set to no, it could find Int, int, iNt, INT, inT, etc. Also you may place a question mark in the search field to represent any character. If you were to search for i?t it could find int, ibt, ict, izt, etc. To set a field, press ALT 1 before you type in any search text. Now press the capitalized letter(s) of the options you wish to select, and then press the Esc key to resume typing the search text. USING REPLACE When you select the replace command your screen should look like this: Search string: DIRECTION: Up Down CASE: Yes No CONVERT TO: uPper Lower nEither CONFIRM: yeS nO The direction and case fields are the same as in search, but Convert and Confirm are different. Convert is used to change the case of letters. If you place a question mark in the replace text, then when ACE finds match, it will convert the character in the same position of the question mark to upper case, lower case, or not convert at all. If you were to search for ? and replace with ? and have convert set to upper case it would convert all the characters it found to upper case. If you have selected Confirm, ACE will ask you in each instance whether or not to perform the replace before actually doing it. CHANGING THE ATTRIBUTES ACE - Page 5 - The attributes window can be opened by selecting Attributes from the main menu, or by pressing the F5 key. After loading in the data file it should look something like this: ╔═════════════════════════════╗ ║NORMAL TEXT COLOR F ║ ║BLOCK COLOR 70║ ║END OF FILE COLOR F0║ ║CARRIAGE RETURN COLOR 7 ║ ║BORDER COLOR 7 ║ ║CARRIAGE RETURN CHARACTER ║ ║THUMB CHARACTER ╫ ║(ASCII 215) ║END OF FILE CHARACTER ║(ASCII 4) ║START UP INSERT (1/0) 1 ║ ║TAB SIZE (0-8) 8 ║ ║COLUMN START POS. (1/0) 1 ║ ╚═════════════════════════════╝ Shown are the default values for ACE. The top five options are displayed in HEX; these options control the colors that you see on your screen. The next three are characters that ACE will display on different parts of the screen. The next is either a 1 or a 0. The next is anything from 0 to 8, and the next option is a 1 or a 0 The hex attributes in the first five options can be determined by looking in the BASIC manual under the color statement. The first number is the background color, which can be from 0 to F. The second number is the foreground color, which can also be from 0 to F. So if you want inverse, white on black, for an option, you would type 70 for the field, meaning a background of 7 and a foreground of 0. The first option, text color, defines what normal text looks like. The second option, block color, defines what color blocks will be. The third, end of file color, defines what color the end of file mark will be. The fourth, carriage return color, defines what color the end of line mark will be. The fourth option, border color, defines what color the border will be. THE 15 POSSIBLE COLORS ARE: 0 - BLACK 8 - GRAY 1 - BLUE 9 - LIGHT BLUE 2 - GREEN A - LIGHT GREEN 3 - CYAN B - LIGHT CYAN 4 - RED C - LIGHT RED 5 - MAGENTA D - LIGHT MAGENTA 6 - BROWN E - YELLOW 7 - WHITE F - HIGH INTENSITY WHITE The character attributes can be any one character. The carriage return character is what appears at the end of every line. The thumb character is the character ACE uses at the side of the window to represent your position in the document. The end of file character is the character that you see at the end of the document. The next field, start up insert state, specifies what mode the cursor will be in the next time you load ACE: 1 for insert; 0 for overtype. The next field, specifies the size of your tabs. If you set it to 0, then ACE will just insert the ASCII 9 character instead. The last field, column start pos, specifies whether line and col start at 0 or 1. When you finish typing in all the new values, they are all automatically saved in a data file. This data file is automatically saved when you quit also, so you may not need to change the start up insert state field, for it will be changed according to what mode you are in when you quit. ACE - Page 6 - WHAT THE CONTRIBUTION GETS YOU When you make a contribution of $35 or more you will become a registered user, receive the latest version, the latest documentation, and notices of new software and revisions from C-STUFF that can be sent to you upon request. (Make sure to send your name, address, and phone number.) You may for $10 have me rewrite ACE for your particular language (please include details about your language, such as what remarks are delimited by, what functions are delimited by, etc). Right now doing this would change the Alt R, and the Alt B functions. If you think this isn't worth the 10 dollars wait until an upcoming version! It will have many, awesome, excellent and fantastic features to help you with your programming. It's your choice though, to wait, or do it now. It's only 10 dollars! If you have any ideas or have found some bugs, please call or write me. If I like your idea or you have found a true bug, I will send you the latest public version. You may only get the LATEST version if you are a registered user, for I will only upload a new version to bulletin boards once every 6 months. Note: When you wish to have an update, send your name, address serial number and $10 to cover for the disk and mailing. You may only send ACE in for rewriting if you are a registered user. COMMAND SUMMARY F1 - Repeats the last search or replace. Alt F1 - Switches between windows. F2 - Takes you to the Files option. Alt F2 - Allows you to open or close a help window. F3 - Search option. F4 - Replace option. F5 - Attributes option. F6 - Starts/stops defining of block. F7 - ** reserved for future use ** F8 - Print option. F9 - Goto option. F10 - Tag option. Alt E - Deletes the line that the cursor is on. Alt O - Inserts a line below the cursor and positions the cursor under the first non-space line. Alt X - Allows you to enter any ASCII code. (can not enter code 254!) Block Commands: Alt R - Places remarks around a block or a line. Alt C - Copies the block to the cursor position. Alt D - Deletes the block. Alt M - Moves the block to the cursor position. Alt L - Deletes the line the cursor is on and inserts the block. Alt B - Deletes everything inside the nearest braces and inserts the block. --> - Cursor right. <-- - Cursor left. (up arrow) - Cursor up. (down arrow) - Cursor down. Home - Beginning of line. End - End of line. PgUp - Page up. PgDn - Page Down. -- - Destructive backspace. Ins - Toggle insert/overtype. ACE - Page 7 - Del - Delete character. Ctrl --> - Word right. Ctrl <-- - Word left. Ctrl Home - Top of window. Ctrl End - Bottom of window. Ctrl Pg Up - Beginning of file. Ctrl Pg Dn - End of File. Scroll Lock - Toggles special cursor movement mode: --> (right arrow) - scroll right 4 X tab size. <-- (left arrow) - scroll left 4 X tab size. (down arrow) - scroll down half a screen. (up arrow) - scroll up half a screen. Home - move cursor to left edge of screen. End - move cursor to right edge of screen. «